home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / Reference / DevCon / Orlando_1993 / Devcon93.1 / DebugTools / MapBoard.doc < prev    next >
Encoding:
Text File  |  1992-11-18  |  2.5 KB  |  78 lines
  1. TABLE OF CONTENTS
  2.  
  3. MapBoard
  4. MapBoard                                                             MapBoard
  5.  
  6.    NAME
  7.     MapBoard - A 68040 Expansion Board ROM mapper
  8.  
  9.    SYNOPSIS
  10.     MapBoard will let you map the ROM of an I/O board as cacheable
  11.     at specific addresses on 68040 systems.
  12.  
  13.    FUNCTION
  14.     MapBoard will use the MMU to map sections of an I/O board's
  15.     address space as cacheable such that things like device drivers
  16.     can run in the CPU instruction caches.  No memory should be
  17.     used by this program.
  18.  
  19.     This program only is useful for 68040 based systems running
  20.     V37.10 or later of the 68040.library.
  21.  
  22.     All options are also available from icon tooltypes in either
  23.     project or tool icons.
  24.  
  25.    INPUTS
  26.     MANUFACTURE/N    - The Manufacture autoconfig ID for the board
  27.  
  28.     PRODUCT/N    - The Product autoconfig ID for the board
  29.  
  30.     OFFSET/N    - The address offset from the start of the board
  31.               where caching should begin.  This is rounded up
  32.               to the nearest page address.
  33.  
  34.     SIZE/N        - The length in bytes of the cacheable area.
  35.               This will be rounded to the page size as
  36.               to only cache pages that are completely
  37.               contained within the area from OFFSET to
  38.               OFFSET+SIZE
  39.  
  40.     A2091/S        - Do the Commodore-Amiga A2091 hard drive
  41.               controller ROM.  This makes the A2091
  42.               run over 10 times faster on the A4000
  43.               when talking to non-DMA memory.
  44.  
  45.    RESULTS
  46.     The MMU tables are modified to show the specific pages as
  47.     cacheable.  MapBoard does not (currently) produce any error
  48.     messages.
  49.  
  50.    WARNING
  51.     Specifying invalid SIZE or OFFSET can cause the hardware device
  52.     to fail.  MapBoard does not any specific knowledge of the hardware
  53.     you are mapping (other than the A2091) and thus can not error
  54.     check your input.
  55.  
  56.    NOTES
  57.     Since this tool modifies the existing MMU tables, toys that play
  58.     with the MMU can cause it to not work.  MapBoard will correctly
  59.     ignore invalid MMU tables as best it can.  The tables must be
  60.     4K page size and be fully valid 68040 tables.
  61.  
  62.     Also, since Enforcer and such tools install a new MMU table
  63.     when they run, you will need to run MapBoard after starting
  64.     Enforcer.  If you quit Enforcer and then restart Enforcer
  65.     you will need to run MapBoard again.  If you run MapBoard
  66.     before Enforcer, Enforcer will correctly restore the MMU
  67.     settings when it quits.  So, if you ever do run Enforcer and
  68.     turn it off you may wish to have MapBoard run BEFORE you
  69.     run Enforcer and after each time you start Enforcer.
  70.  
  71.    SEE ALSO
  72.     "A master's secrets are only as good as the
  73.      master's ability to explain them to others."  -  Michael Sinz
  74.  
  75.    BUGS
  76.     None?
  77.  
  78.